# Development environment setup

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

# Host requirements

The performance of a Linux development workstation should be higher than the minimum requirements for running Ubuntu 64-bit operating system on a general desktop system. To speed up compilation time, it is recommended to use a powerful PC with the following recommended configurations:

| **Hardware configuration** | **Software tool** |
| --- | --- |
| x86 computer | Git 1.8.3.1 or higher |
| Quad-core CPU, e.g., Intel i7-2600 at 3.4 GHz (equivalent or higher) | Tar 1.28 or higher |
| 300 GB available disk space (swap partition > 32 GB) | Python 3.10.2 or higher |
| 16 GB RAM or more | GCC 7.5 or higher |
| Ubuntu 22.04 (64-bit) | GNU Make 4.0 or higher |

## System environment

| **Purpose** | **System requirement** |
| --- | --- |
| Linux compilation machine | Ubuntu 64-bit 22.04 |
| Firmware flashing tool (optional) | Windows 10 or higher |

**Tip**  
It is recommended to use Ubuntu 22.04 LTS for compilation, because this version has been fully tested and verified.

# Linux environment configuration

## Install build tools

To prepare the host environment for **Yocto** builds, you can use the command below to update packages and install all required tools:

```bash
sudo apt update
sudo apt install repo gawk wget git diffstat unzip texinfo gcc build-essential chrpath socat cpio python3 python3-pip python3-pexpect xz-utils linuxutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev pylint xterm python3-subunit mesa-common-dev zstd liblz4-tool locales tar python-is-python3 file libxml-opml-simplegen-perl vim whiptail g++ && pip3 install pyhocon
```

# Windows flashing tools (optional)

If you need to perform firmware flashing operations on a Windows system, you need to install the following tools:

## QFIL flashing tool

**QFIL** (Qualcomm Flash Image Loader) is a professional firmware flashing tool for Qualcomm platforms, used to flash compiled images to development boards.

**Installation steps:**

1. Download the **QPST** toolkit (including the QFIL tool)

2. Run the installer and complete the installation

3. Install Qualcomm USB drivers (ensure PC can recognize the development board)

# Next steps

After the environment setup is complete, you can proceed with the following operations:

- **Clone code and compile images**: See [Image build](<../Image build/Image build.md>) for details

- **Flash firmware to development board**: See [Image flashing](<../Image flashing/Image flashing.md>) for details